home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_7 / issue_04 / psion_3 / s3emuldoc < prev   
Encoding:
Text File  |  1993-12-06  |  7.8 KB  |  189 lines
  1. PC emulation of Series3
  2. =======================
  3.  
  4. This document describes EHWIM.EXE, a PC emulation of the Series3
  5. environment.
  6.  
  7. If you are developing either C programs or Opl programs for the
  8. Series3, you may find that using EHWIM.EXE can significantly increase
  9. your productivity over many parts of the development life-cycle.
  10.  
  11. Copyright notice
  12. ----------------
  13. (C) Copyright Psion PLC 1992.
  14.  
  15. All rights reserved.  The program EHWIM.EXE, the other files in the
  16. PC emulator of the Series3, and the accompanying documentation are
  17. copyrighted works of Psion PLC, London, England.  Reproduction in
  18. whole or in part, including utilisation in machines capable of
  19. reproduction or retrieval, without express written permission of
  20. Psion PLC, is prohibited.  Reverse engineering is also prohibited.
  21.  
  22. Conditions of use of EHWIM.EXE
  23. ------------------------------
  24. EHWIM.EXE is NOT supported by Psion.  Please do not telephone any
  25. Psion personnel (Support or otherwise) with any questions regarding
  26. EHWIM.
  27.  
  28. (The concept of a tool being released but not supported should be
  29. familiar to developers who work with any other large software system.)
  30.  
  31. Any questions regarding EHWIM should ONLY be raised in the PSION
  32. conference on CIX, where unofficial support may be available from
  33. time to time, and where other EHWIM users may also help you.
  34.  
  35. EHWIM.EXE was originally developed for use purely inside Psion
  36. Software Development, and only runs within a limited set of
  37. circumstances.  In view of the potential assistance it may provide to
  38. other people writing software for the Series3, it is being released
  39. "as is" on CIX.
  40.  
  41. Releasing an internal tool in this way on CIX is an experiment.  If
  42. people disregard the above request, and telephone Psion with
  43. questions about EHWIM, the experiment will not be repeated - ie no
  44. other tools, documentation, etc, will be released in a similar way on
  45. CIX in the future.  Instead, these other tools and documentation will
  46. simply remain un-released.
  47.  
  48. The proper role of the emulator
  49. -------------------------------
  50. In no circumstances should programs be released for use on the
  51. Series3 without being fully tested ON A SERIES3 ITSELF.  The fact
  52. that a program runs on a PC emulation of the Series3 in no way
  53. guarantees that it will run on a Series3 itself.
  54.  
  55. The role of the emulator is to speed up the earlier parts of program
  56. development, and more routine program development, before the program
  57. receives more serious testing on a real Series3.
  58.         
  59. Limitations of the emulator
  60. ---------------------------
  61. This release of EHWIM comes with the Time and Word applications, and
  62. the Program alias.  This will allow you to edit, translate and run
  63. Opl programs on a PC.
  64.  
  65. The emulator will only run on truly IBM-compatible PCs.  The emulator
  66. is unlikely to run successfully on DOS emulations or inside "DOS
  67. boxes" such as under OS/2 or Windows.  Serial mice may have to be
  68. removed before you can run the emulator successfully.
  69.  
  70. The hardware of a PC is, of course, different from the hardware on
  71. the Series3.  This particularly effects comms parts of programs.  For
  72. example, a program that prints via the serial port or parallel port
  73. will appear to work correctly, on a PC, even if no parallel lead or
  74. serial lead is connected to the PC, whereas an error message will be
  75. given in the corresponding case on the Series3.
  76.  
  77. The low-level filing systems on the emulator do not match those on
  78. the Series3.  For example, the notifier "Please replace the SSD"
  79. never arises on the emulator, and as a result, the important error
  80. condition "User abandoned" can never be tested on the emulator.  Disk
  81. caching on the PC can also give rise to unexpected results, differing
  82. from on the Series3.  There are other error messages, such as "O/S
  83. error", that can arise on the PC, but never on a Series3.
  84.  
  85. There is no hardware address trapping on the PC.  Aberrant programs
  86. which would be terminated by the O/S on the Series3 with Exit Number
  87. 60, will trash random memory locations on the PC.
  88.  
  89. Note that when the emulator is exited, applications have no chance to
  90. save any data to file.
  91.  
  92. Installing EHWIM.EXE on a PC
  93. ----------------------------
  94. The PC emulator actually consists of more than one file (not all of
  95. which are needed every time the emulator runs).  In all these files
  96. are distributed among FIVE different zip files in the FLIST of the
  97. PSION SERIES3 conference:
  98.         ehwim.zip       The main emulator executable, ehwim.exe
  99.                         plus a "configuration" file hhserver.par
  100.         apps.zip        The programs time.app, word.app, and program.als
  101.         wsrvhdhv.zip    A VGA Window Server, wsrvhdhv.img
  102.         wsrvhdhh.zip    A Hercules Window Server, wsrvhdhh.img
  103.         wsrvhdhc.zip    A CGA Window Server, wsrvhdhc.img
  104.  
  105. For a VGA graphics screen, use wsrvhdhv.img.  For Hercules, use
  106. wsrvhdhh.img.  For CGA, use wsrvhdhc.img.  IN EACH CASE, the .img file
  107. has to be renamed to SYS$WSRV.IMG before the emulator will run.
  108.  
  109. Choose a suitable top-level directory to run the emulator from (say
  110. the directory c:\s3emul).  Unzip EHWIM.ZIP and at least one of WSRV*.ZIP
  111. into this directory.
  112.  
  113. Make an APP subdirectory of the initial directory (say c:\s3emul\app),
  114. go there, and unzip APPS.ZIP there.
  115.  
  116. BEFORE THE EMULATOR WILL RUN, you MUST perform a DOS SUBST of drive m:
  117. to the chosen top-level directory.  Eg type the DOS command
  118.     subst m: c:\s3emul
  119. (see below for more details of SUBST).
  120.  
  121. Failure to correctly SUBST drive m: will lead to the System Screen of
  122. the emulator repeatedly exiting with Exit Number 55.
  123.  
  124. NOTE CAREFULLY that before you can type (eg) "subst m: c:\s3emul" you
  125. must have your value of LASTDRIVE set to be at least as high as 'm'. 
  126. So you may need to add a line such as
  127.     lastdrive=m
  128. to your config.sys (and then reboot the PC).
  129.  
  130. You can rename the file EHWIM.EXE to something more memorable, if you
  131. like.  BUT DO NOT RENAME ANY OF THE OTHER FILES.
  132.  
  133. To start the emulator, simply type "ehwim".
  134.  
  135. Special key-presses
  136. -------------------
  137. F1 is the SYSTEM button, F2 is the DATA button, and so on up to F8
  138. which is the PROG button.  F9 is the MENU key and F10 is HELP.
  139.  
  140. F11 simulates turning the Series3 off then on again: this has a
  141. visible effect only if a password is set.
  142.  
  143. The ALT key has the same function as the PSION key on the Series3.
  144.  
  145. To exit the emulator and return to DOS, press and hold down CTRL-ALT-ESC.
  146.  
  147. Auto-installing applications
  148. ----------------------------
  149. To have one of your programs auto-installed and auto-started whenever
  150. the emulator starts, copy it into m:\app and give it the name eg DATA.APP.
  151.  
  152. (Note however that applications containing embedded DYLs shouldn't be
  153. renamed in this way as they will not run successfully.)
  154.  
  155. Large and small screen versions of the emulator
  156. -----------------------------------------------
  157. The emulator is initially set up to create TWO copies of its display
  158. on the screen: a small one that matches the Series3 pixel for pixel,
  159. and a large one that is easier to read.
  160.  
  161. To turn off the second display, you have to edit (use a text editor
  162. such as Brief) the file HHSERVER.PAR that is part of the emulator, to
  163. make its contents as follows
  164.     SERVER_PARAMS -X240 -Y80
  165. ie removing the final -M -N that actually creates the magnified display.
  166.  
  167. The main drawback of running in the magnified mode is that some
  168. aspects of the emulator run more slowly.  (You may like to experiment
  169. removing only the final -N flag).
  170.  
  171. Notes on SUBST-ing
  172. ------------------
  173. When the emulator starts, it will make very frequent accesses to the
  174. a: floppy disk drive, resulting in a sound sometimes likened to a
  175. machine gun.
  176.  
  177. To disable this, you can redirect a: elsewhere, if you like.  For
  178. example, create a directory c:\acolon, and then type
  179.     subst a: c:\acolon
  180.  
  181. You may also wish to do a similar SUBST for b:.
  182.  
  183. Don't forget to un-subst a: after you have finished with the emulator
  184. - otherwise you won't be able to use the real floppy disk drive.
  185.  
  186. These notes prepared
  187. --------------------
  188. By David Wood, Psion Software Development, on 21/9/92.
  189.